###User Defined Function###
_IEAttach

###Description###
Verknpft sich mit der angegebenen Instanz des Internet Explorers, die der gesuchte String - abhngig vom Suchmodus - enthlt.

###Syntax###
#include <IE.au3> 
_IEAttach ( $s_string [, $s_mode = "title" [, $i_instance = 1]] )


###Parameters###
@@ParamTable@@
$s_string
	Gesuchter String (fr "embedded" oder "dialogbox": Teil des Titels oder HWND des Fensters verwenden)
$s_mode
	[optional] legt den Suchmodus fest:
		"title" = (Standard) Teil des Titels des Hauptdokuments
		"windowtitle" = Teil des gesamten Fenstertitels (anstelle des Dokumenttitels)
		"url" = Teilstring oder URL der aktuellen Internetadresse
		"text" = Teilstring im Text des Bodys der aktuellen Seite
		"html" = Teilstring im HTML des Bodys der aktuellen Seite
		"hwnd" = Handle des Browser-Fensters
		"embedded" = Teil des Titels oder Handle des Fensters, das das IE-Browserobjekt enthlt
		"dialogbox" = Teil des Titels oder Handle der modalen/nichtmodalen Dialogbox
		"instance" = $s_string wird ignoriert, es wird ein Verweis auf eine existierende Browserinstanz zurckgegeben, deren Instanznummer mit der gesuchten $i_instance bereinstimmt
$i_instance
	[optional] 1-basierender Index in eine Gruppe von Browsern oder eingebetteter Browserobjekte, die $s_string und $s_mode entsprechen. Siehe Bemerkungen.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Gibt eine Objektvariable als Referenz auf ein IE-Browserobjekt zurck, die Modi Embedded und DialogBox geben jedoch ein Fensterobjekt zurck.
Fehler:	Gibt 0 zurck und setzt @error
@error:	5 ($_IEStatus_InvalidValue) = Ungltiger Wert
	7 ($_IEStatus_NoMatch) = Keine bereinstimmung
@extended:	Enthlt die Nummer des ungltigen Parameters
@@End@@


###Remarks###
<a href="_IEAttach.htm">_IEAttach()</a> bietet den "dialogbox"-Parameter zur Verknpfung mit modalen und nichtmodalen Dialogen an, welche vom Browser erstellt werden.
Es ist wichtig festzustellen, dass nicht alle Dialoge, die durch Browser-Interaktion erstellt werden, auf diesem Wege verknpft und kontrolliert werden knnen.
Viele dieser Dialoge sind sogar Standardfenster und knnen mit den blichen AutoIt-Fensterfunktionen kontrolliert werden.
Ein zuverlssiger Weg, die Unterschiede dieser Fenstertypen herauszufinden, ist die Benutzung des "AutoIt Window Info"-Tools: 
Enthlt das Fenster ein Control mit dem Namen "Internet Explorer_Server", dann kann diese Funktion darauf angewendet werden,
anderenfalls ist es ein Standardfenster und die blichen AutoIt-Fensterfunktionen mssen zu dessen Kontrolle verwendet werden.

Die "embedded"-Option kann zur Verknpfung mit HyperTextApplication-Fenstern (.hta) verwendet werden.

Die erweiterte Fenstertitel-Syntax der Standard-Fensterfunktionen kann anstelle des Titel-Teilstrings fr die Modi "dialogbox" und "embedded" verwendet werden.


Benutzung von $i_instance im "embedded"-Modus: gibt eine Referenz auf eine bestimmte Instanz des Browserobjekts zurck und kann ntzlich sein,
wenn mehr als ein Browserobjekt in einem Fenster existieren. Wenn ein Fenstertitel in $s_string im embedded-Modus bergeben wird,
wird nur das erste zutreffende Fenster benutzt. Sollte sich das bentigte WebBrowser-Control in einem anderen Fenster befinden,
muss statt des Titels das Fenster-Handle bergeben werden, oder es kann die erweiterte Fenstertitel-Syntax der Standard-Fensterfunktionen verwendet werden.


Benutzung von $i_instance in allen anderen Modi (auer "embedded"): gibt eine Referenz auf ein Browserobjekt aus der Gruppe aller Fenster zurck,
auf die die Suchkriterien laut $s_string und $s_mode zutreffen. Die Instanzenreihenfolge im "dialogbox"-Modus stimmt mit der von <a href="../functions/WinList.htm">WinList()</a> gelieferten Trefferliste berein.
In allen anderen Modi entspricht die Reihenfolge der Shell.Windows Collection.

$i_instance wird auf 1 gesetzt und eine Warnung wird ausgegeben, wenn $i_instance > 1 ist und die Modi "hwnd" oder "dialogbox" mit einem Fensterhandle (HWnd) in $s_string benutzt werden.

Die Modi "dialogbox" und Embedded knnen zur Verknpfung mit Standard-Browserfenstern benutzt werden,
allerdings ist das zurckgegebene Objekt das Top-Level-Fenster im Browser und nicht das InternetExplorer-Objekt selbst.
Fensterobjekte bieten nicht auf alle Attribute des IE-Objekts Zugriff (z.B. Statustext, Adressleiste etc.).
Wenn also versucht wird, Funktionen wie <a href="_IENavigate.htm">_IENavigate()</a> auf solch ein Objekt anzuwenden, knnen COM-Fehler auftreten, aufgrund der Tatsache wie die Tabs in IE7 implementiert sind.
Es mag ntzlich sein, Browserinstanzen auf diese Weise zu ermitteln, es wird aber empfohlen, _IEAttach immer mit einem der anderen Modi und den Informationen,
die ber das Fensterobjekt bekannt sind, zu benutzen, um die Referenz auf das dazugehrige InternetExplorer-Objekt zu erhalten.


###Related###
_IECreate, _IECreateEmbedded, _IEQuit


###Example###
@@IncludeExample@@
